@database CatchDisk.guide @remark $VER: CatchDisk.guide 1.20 (26.4.94) Alessandro Sala @node Main "CatchDisk: Guida utente" ------------------------------------------------------------------------------ CatchDisk versione 1.20 26-Apr-1993 Copyright 1994 By Alessandro Sala dedicato a Cristina Richiede AmigaOS v2.04 ( Kickstart v37 ) o successivo e WBStart-Handler v1.4 o successivo (by Stefan Becker) ------------------------------------------------------------------------------ Contenuti - @{"Informazioni legali " link legal} - @{"L'archivio di distribuzione" link archive} - Introduzione @{"Cos' CatchDisk ? " link whatis} @{"Installazione " link install} - @{"Configurazione e utilizzo " link usage} - @{"Terminare CatchDisk " link term} - @{"Indirizzi per contatti " link contact} - @{"Storia delle revisioni " link history} ****************************************************************** NOTA: Il mio indirizzo E-Mail cambiato. Il nuovo indirizzo +----------------------------------------------------------------+ | | | Alessandro Sala | | | | tser1500@cdc8g5.cdc.polimi.it | | | +----------------------------------------------------------------+ @endnode @node legal "Informazioni legali" ---------------- Responsabilit ---------------- Questo programma fornito SENZA alcuna garanzia, n esplicita n implicita, di adeguatezza ad un particolare utilizzo. Sebbene sia stata posta la massima cura nel rendere questo programma 'system-friendly' e privo di bug, l' intero rischio per quello che riguarda i risultati, l' affidabilit e le prestazioni di questo programma assunto dall' utente: NESSUNA responsabilit potr essere imputata all' Autore per qualsivoglia danno prodotto dal programma stesso. ------------------- Nota di Copyright ------------------- Questo programma 'FreeWare': pu essere liberamente copiato e distribuito per fini non commerciali e comunque non di lucro, purch non venga aggiunto n eliminato alcun file dall' archivio di distribuzione, e non venga richiesto alcun pagamento, a parte un eventuale contributo ai costi di copia. Fred Fish , naturalmente, esplicitamente autorizzato a distribuire questo programma mediante la sua 'disk library' e/o i suoi CD-ROM. Tuttavia il programma rimane Copyright dell' Autore: sono vietate operazioni di 'reverse engineering', adattamenti e qualunque altra modifica al programma, alla documentazione e ad ogni altro file presente nell' archivio, tranne dove sia esplicitamente premesso. E' permesso comprimere il programma in una forma eseguibile per uso personale, non per la distribuzione. Le uniche due forme permesse di distribu- zione sono l'archivio lha originale o una sua forma decompressa. Inoltre vietato incorporare il programma in un altro software senza il permesso scritto dell' Autore. @endnode @node archive "L'archivio di distribuzione" ----------------------------------------- Contenuto dell' archivio di distribuzione ----------------------------------------- CatchDisk : Il programma principale CatchDisk.info : Relativo file '.info' con tooltypes predefiniti Italiano Leggimi : Informazioni generali in lingua italiana Documentazione CatchDisk.doc : Documentazione italiana in formato ASCII CatchDisk.guide : Documentazione italiana in formato AmigaGuide Installa : Programma di installazione in italiano (vedi Leggimi) English Readme : Informazioni generali in lingua inglese Documentation CatchDisk.doc : Documentazione inglese in formato ASCII CatchDisk.guide : Documentazione inglese in formato AmigaGuide Install : Programma di installazione in inglese (vedi Readme) Deutsch ( traduzioni di Jan-Claas Dirks ) Liesmich : Informazioni generali in lingua tedesca Dokumentation CatchDisk.dok : Documentazione tedesca in formato ASCII CatchDisk.guide : Documentazione tedesca in formato AmigaGuide Install : Programma di installazione in tedesco (vedi Liesmich) Catalogs CatchDisk.ct : File di traduzione vuoto italiano CatchDisk.catalog : File di supporto per la lingua italiana deutsch CatchDisk.catalog : File di supporto per la lingua tedesca (traduzione di Jan-Claas Dirks) Vari file '.info' @endnode @node whatis "Introduzione" Cos' CatchDisk ? ---------------- CatchDisk una semplice commodity, la cui principale funzione consiste nel rilevare l' inserimento di nuovi dischi nei drives e verificare se sono gi correttamente formattati: se non lo sono viene lanciato il programma Format con il drive gi selezionato. All' utente non resta che scegliere le opzioni e attivare la formattazione o annullare l' operazione. A partire dalla versione 1.20, CatchDisk pu riconoscere vari dischi in formato non-DOS e ignorarli o eseguire un programma a scelta dell'utente, quando vengono inseriti. Per ulteriori informazioni e altre caratteristiche di CatchDisk, continuate a leggere. IMPORTANTE ---------- Per potere utilizzare CatchDisk necessario installare nella vostra directory L: il programma WBStart-Handler VERSIONE 1.4 O SUCCESSIVA. WBStart-Handler prodotto da Stefan Becker ed liberamente distribuibile: l' archivio di distribuzione 'WBStart1_4.lha'. Assicuratevi che la versione sia almeno la 1.4, perch con versioni precedenti, a causa di un problema nella gestione dei lock nulli nell' handler, CatchDisk non funzionerebbe correttamente. @endnode @node install "Introduzione" Installazione ------------- Per installare CatchDisk, se avete l'utility 'Installer' della Commodore (vedi @{"'Leggimi'" link "/Leggimi/main"}), potete semplicemente eseguire l'icona 'Installa' che trovate nel cassetto 'Italiano'. Altrimenti sufficente copiare CatchDisk in un cassetto, tipicamente SYS:WBStartup. Se avete OS 2.1 o successivo e volete sfruttare la localizzazione, dovete anche copiare il cassetto 'catalogs', che si trova nell'archivio di distribuzione, nello stesso cassetto di CatchDisk, oppure potete copiare il file 'CatchDisk.catalog' (si trova in 'catalogs//') in 'LOCALE:catalogs//', dove quella desiderata. Se la vostra lingua non ancora supportata, potete completare il file di traduzione che trovate nel cassetto 'catalogs' ( catalogs/CatchDisk.ct ) e inviarmelo via E-Mail (vedi la sezione @{"Indirizzi per contatti" link contact} ). Io creer un nuovo file '/CatchDisk.catalog' e ve lo invier via E-Mail il presto possibile, e la prossima versione di CatchDisk supporter una nuova lingua. Potete anche tradurre i file di documentazione ed inviarmeli perch siano inclusi nella distribuzione di CatchDisk. Assicuratevi inoltre di avere installato nella vostra directory L: il WBStart-Handler versione 1.4 o successiva (vedi @{"'Cos' CatchDisk'" link whatis 17}) @endnode @node usage "Configurazione e utilizzo" Per lanciare CatchDisk sufficente 'bi-cliccare' la sua icona o dare il comando 'run CatchDisk' da una CLI. Per averlo attivo ad ogni boot, mettetelo nel cassetto SYS:WBStartup con il tooltype 'DONOTWAIT', oppure inserite il comando 'run CatchDisk' nel file S:user-startup. CatchDisk riconosce i seguenti tooltype o argomenti da CLI: CX_PRIORITY= : La priorit di CatchDisk nella rete delle commodity. Default = 0. Intervallo = da -128 a 127 DEVICE=... : Descrive un gruppo di drives alternativi per un singolo drive fisico. Il numero identifica un gruppo di drives alternativi, e pu assumere valori da 0 a 9. Il parametro un nome di drive seguito da ':' ed possibile elencare un numero qualsiasi di drives, senza spazi interposti. Esempio: 'DEVICE0=DF0:PC0:' indica che perch un disco sia considerato correttamente formattato deve essere leggibile accedendo al drive come DF0: oppure come PC0: Se in nessuno dei due casi il disco risulta leggibile, CatchDisk tenter di identificarlo leggendo i primi 4 bytes della traccia 0 (che sono i 4 caratteri che potete vedere come nome dell'icona del disco sul Workbench, dopo DFx:). Se il disco viene riconosciuto, viene intrapresa un'azione in base ai tooltypes @{"REQUESTER" link usage 107} e @{"ID" link usage 70}, altrimenti ,in base al tooltype @{"REQUESTER" link usage 107}, verr eseguito il @{"programma di formattazione" link usage 65} sul primo drive della lista (nel nostro esempio sar DF0:). Se si fosse invece indicato: 'DEVICE0=PC0:DF0:' in caso di disco non formattato o non rico- nosciuto sarebbe stato formattato come 'PC0:'. Se uno o pi dei drives elencati non sono montati, vengono semplicemente ignorati. BREAK_WARN : Quando CatchDisk @{"termina" link term} a causa di un segnale ^C, esso visualizza un requester che vi informa dell'evento solo se BREAK_WARN definito. RESCAN= : Forza CatchDisk ad effettuare una nuova scansione dei vari devices ogni secondi. Questo permette a CatchDisk di accorgersi quando viene montato un device che non invia il messaggio 'diskinserted' (es. dischi simulati montati mediante FMS). Default = 0 (niente rescan). FORMATTER= : Permette di specificare un programma di formatta- zione diverso da 'SYS:System/Format', che default. Dovete specificare il percorso completo del programma da eseguire. ID=[,[,]] : Descrive un formato disco non-DOS. La cifra pu variare tra 0 e 9: i numeri pi bassi vengono controllati prima. un identificatore di quattro caratteri che deve coincidere con i primi 4 bytes della traccia 0 del disco, per identificarlo. Ci sono due caratteri speciali: $ : Corrisponde solo ad una cifra (0-9) o ad un '$'. ? : Corrisponde a qualsiasi carattere. Cos , per esempio, Qb$$ identifica tutti i dischi di Quarterback (Qb01, QB02 ecc.). un testo che viene utilizzato per comunicare all'utente che tipo di disco CatchDisk ha identificato. Viene anche usato come etichetta per il gadget del requester (vedi sotto). Se non fornito il disco verr sempre ignorato, indipendentemente dal tooltype @{"REQUESTER" link usage 107}. il path e il nome del programma che viene eseguito quando CatchDisk identifica questo formato. L'esecuzione di questo programma l'azione di default che viene intrapresa da CatchDisk se il tooltype @{"REQUESTER" link usage 107} vale NOID o NEVER. Se non fornito, viene utilizzato il @{"programma di formattazione" link usage 65}. Potete trovare alcuni esempi nell'icona di CatchDisk. REQUESTER= : Dove vale NEVER, ID, NOID o ALWAYS. Quando CatchDisk rileva un disco non-DOS, pu eseguire un'azione di default oppure pu aprire un requester per chiedere all'utente cosa fare. Per i dischi illeggibili/non riconosciuti le azioni possibili sono 'Formatta' o 'Ignora'. Il default e 'Formatta'. Per i dischi riconosciuti, le azioni sono 'Ignora', 'Formatta', o 'esegui il programma' indicato nel relativo tooltype @{"ID" link usage 70}. Il default consiste nell'esecuzione del programma indicato. Se =NEVER, CatchDisk procede sempre con l'azione di default (vedi sopra), senza chiedere all'utente. Se =ID, CatchDisk apre il requester solo per i dischi identificati, altrimenti esegue l'azione di default. Se =NOID, CatchDisk apre il requester solo per i dischi illeggibili o non riconosciuti, altrimenti esegue l'azione di default. Se =ALWAYS, CatchDisk apre sempre il requester. Quando CatchDisk attivo, potete usare il programma Commodities Exchange per controllarne l' attivit @endnode @node term "Terminare CatchDisk " Essendo una commodity, CatchDisk pu essere terminato in tre modi: a) Eseguite CatchDisk una seconda volta. b) Usate il programma Commodities Exchange. c) Inviate a CatchDisk un segnale 'control-C' (vedi anche @{"BREAK_WARN" link usage 50}): c.1) Se avete lanciato CatchDisk da workbench (o dal cassetto WBStartup) usate una utility di controllo dei task come TaskX di Steve Tibbet. c.2) Se avete lanciato CatchDisk da una CLI (o da user-startup) fate cos 1) Aprite una CLI 2) Date il comando 'STATUS' e notate il numero di processo di CatchDisk 3) Date 'BREAK C' dove il numero di processo visto sopra @endnode @node contact "Indirizzi per contatti" Critiche e suggerimenti ----------------------- Spero che troviate CatchDisk utile, e se avete delle critiche, dei suggerimenti, segnalazioni di bug, idee per miglioramenti in eventuali nuove versioni, oppure se avete problemi con CatchDisk e avete bisogno di aiuto, potete scrivermi ( in Italiano o in Inglese ) al seguente indirizzo: Alessandro Sala Via A. Grandi, 16 20014 Nerviano (MI) Italy Se potete usare la posta elettronica (E-Mail), potete anche contattarmi al seguente (nuovo) indirizzo Internet (almeno fino alla fine di Luglio 1994): tser1500@cdc8g5.cdc.polimi.it @endnode @node history "Storia delle revisioni" ********************************************************************************** Revisioni ********************************************************************************** ------------- Versione 1.20 ------------- - Eliminati vari bug che si presentavano in presenza di pi di un device PCx: (doppie richieste di formattazione, richieste di formattazione all'estrazione di un disco ecc.). Risolti i problemi nel riconoscimento di dischi NDOS in presenza di un device PCx:. - Aggiunta la capacit di identificare dischi non-DOS (suggerito anche da Jan-Claas Dirks) e intraprendere delle azioni definite dall'utente. - Aggiunti requester opzionali prima di eseguire qualsiasi azione. - Aggiunta la possibilit di utilizzare un programma di formattazione scelto dall'utente. - Aggiunto il supporto per la lingua Tedesca (grazie a Jan-Claas Dirks). ------------- Versione 1.10 ------------- - Quando CatchDisk viene riattivato, dopo essere stato disattivato tramite 'Exchange', effettua una nuova scansione dello stato dei vari devices per verificare se vi sono nuovi dischi da formattare. - Aggiunto il tooltype 'RESCAN=' che forza CatchDisk ad effettuare una nuova scansione dello stato dei vari devices ogni secondi, cos da rilevare anche quelli che non inviano i messaggi 'diskinserted' e 'diskremoved', per es. dischi simulati montati mediante FMS (segnalato da Frank Schliefer) ------------- Versione 1.00 ------------- Prima release. @endnode